home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / dev / c / mkid.readme < prev    next >
Text File  |  1995-10-10  |  7KB  |  138 lines
  1. Short:  V1.3, a program identifier database package
  2. Author: Greg McGary, Randell Jesup, Olaf Barthel
  3. Type:   dev/c
  4.  
  5.     I got this back in 1987, and have been using it since then.  It
  6. is freely redistributable (see the original writer's copyright message).
  7. My modifications and the 2 routines I added are public domain.  It also
  8. uses Chuck McManis's cooked IO routines.
  9.  
  10.     To compile under amigados, you must use -Dfseek=unixfseek.  This
  11. is because the program assumes fseek will extend the file, which is not
  12. normally true under amigados.
  13.  
  14.     It needs an amigados makefile (badly).  Don't forget to include
  15. amiga.c, amiga_getenv.c, and raw.o.
  16.  
  17.     It could use some of the 2.0 routines (like the pattern-matching
  18. in place of unix RE's, and GetVar() in amiga_getenv.c).  Under 2.0 you
  19. can use one executable and hardlink the others (it keys off the name it
  20. was run under).
  21.  
  22.     It's pretty stable.  Unix-pathing has been replaced with amiga-
  23. pathing (., .., etc).  The amiga-specific changes to the main code are
  24. ifdef AMIGA.
  25.  
  26.     Randell Jesup
  27.  
  28.  
  29.  
  30.     Just about four years later I found this tool on the
  31. Frozen Fish CD-ROM. Neat! But some feature were missing, such as the
  32. regexp support in the lookup utilities and wildcard file name expansion
  33. in mkid. I also found one or the other bug that needed fixing. For
  34. example, if a lookup tool didn't find the ID database in its current
  35. drawer or some parent drawer, it would cause Enforcer hits and change
  36. the calling Shell's current directory without ever restoring it.
  37. Rebuilding the tools using SAS/C was a good idea, the tools are all
  38. pure now and can be made resident. I also threw in some 2.0 additions,
  39. notably the editor launch procedure and the wildcard expansion stuff.
  40. The scanner now handles .i and .asm files and the lookup tools will
  41. output proper AmigaDOS wildcard patterns rather than plain regexp
  42. patterns.
  43.     The distribution preserves Fred's original drawer
  44. structure and adds an SAS/C SMakefile. I removed some of the original
  45. source files which were now obsolete. The binaries in the "bin"
  46. drawer were built for an Amiga running Kickstart 2.04 or higher,
  47. using the ieee math libraries. I haven't tested if they still work on
  48. Kickstart 1.3 and friends, they probably won't.
  49.  
  50.     Olaf Barthel <olsen@sourcery.han.de>, 29 June 1995
  51.  
  52.  
  53.     More, small additions: the C scanner now handles C++ style
  54. comments ("//") and recognizes files with .cpp/.cxx/.c++/.hpp/.hxx/.h++
  55. extensions. There is no specific C++ support in the scanner, but it never
  56. checked for C specific data structures anyway ;) The assembly language
  57. scanner now handles comment lines introduced by "*" or ";". Some file
  58. name and name suffix comparisons were case sensitive, which does not
  59. make that much sense on the Amiga; the comparisons now ignore the file
  60. name case. Speaking of case, the lookup tools sport an "-i" option to
  61. enable case-insensitive pattern comparisons. I changed the makefile
  62. slightly to take advantage of the fact that all tools share the same
  63. basic set of support files which are now bound together in a linker
  64. library. This reduced the tool size once again. The tools now use
  65. utility.library for inline math routines. This means that they will
  66. definitely no longer run under Kickstart 1.3 and below. For the record,
  67. all changes I made and routines I added are public domain.
  68.  
  69.     Olaf Barthel <olsen@sourcery.han.de>, 23 July 1995
  70.  
  71.  
  72.     In an attempt to make the raw/cooked I/O routines more
  73. bulletproof I rewrote raw.c. mkid now uses ffp math routines as it
  74. was using floating point arithmetics only to calculate the final
  75. stats it displays after building the database. This made the program
  76. a little smaller without loss of robustness.
  77.  
  78.     Olaf Barthel <olsen@sourcery.han.de>, 17 September 1995
  79.  
  80.  
  81. ============================= Archive contents =============================
  82.  
  83. Original  Packed Ratio    Date     Time    Name
  84. -------- ------- ----- --------- --------  -------------
  85.     3601    1800 50.0% 17-Sep-95 14:52:18  AMIGA_README
  86.    27064   16655 38.4% 17-Sep-95 14:50:30 +aid
  87.    27064   16655 38.4% 17-Sep-95 14:50:30 +eid
  88.    19744   12350 37.4% 17-Sep-95 14:50:34 +fid
  89.    27064   16655 38.4% 17-Sep-95 14:50:30 +gid
  90.    27064   16655 38.4% 17-Sep-95 14:50:16 +lid
  91.    32996   18861 42.8% 17-Sep-95 14:50:28 +mkid
  92.      651     392 39.7% 01-Feb-91 13:00:36 +cookedio.txt
  93.     4020    1763 56.1% 01-Feb-91 13:00:36 +lid.1
  94.     5319    1899 64.2% 29-Jun-95 20:43:54 +lid.man
  95.     4644    1977 57.4% 01-Feb-91 13:00:42 +mkid.1
  96.     6384    2183 65.8% 29-Jun-95 20:44:04 +mkid.man
  97.     4227    1715 59.4% 08-Jul-95 21:46:04 +amiga.c
  98.      705     320 54.6% 01-Feb-91 13:04:20 +basename.c
  99.      643     348 45.8% 01-Feb-91 13:04:20 +bitcount.c
  100.      992     282 71.5% 01-Feb-91 13:04:50 +bitops.c
  101.      537     214 60.1% 01-Feb-91 13:04:58 +bitops.h
  102.     1614     578 64.1% 01-Feb-91 13:04:54 +bitsvec.c
  103.      128     115 10.1% 01-Feb-91 13:04:54 +bool.h
  104.      692     366 47.1% 01-Feb-91 13:03:48 +bsearch.c
  105.      199     160 19.5% 01-Feb-91 13:04:10 +bzero.c
  106.      188     151 19.6% 01-Feb-91 13:02:28 +document.c
  107.     1281     425 66.8% 29-Jun-95 20:48:26 +extern.h
  108.     2453    1102 55.0% 23-Jul-95 17:07:32 +fid.c
  109.      575     367 36.1% 01-Feb-91 13:04:56 +gets0.c
  110.     6104    1876 69.2% 12-Jul-95 21:16:48 +getscan.c
  111.      418     244 41.6% 01-Feb-91 13:04:42 +getsFF.c
  112.     2203     926 57.9% 01-Feb-91 13:04:08 +hash.c
  113.     1716     797 53.5% 01-Feb-91 13:04:22 +id.h
  114.     1449     680 53.0% 23-Jul-95 17:07:40 +idx.c
  115.     1259     614 51.2% 01-Feb-91 13:04:22 +init.c
  116.    19230    5767 70.0% 23-Jul-95 17:07:50 +lid.c
  117.     3610    1448 59.8% 01-Feb-91 13:04:02 +Makefile.unix
  118.    18724    6052 67.6% 23-Jul-95 17:07:58 +mkid.c
  119.       60      44 26.6% 01-Feb-91 13:04:40 +numtst.c
  120.     2373     724 69.4% 01-Feb-91 13:04:12 +opensrc.c
  121.       21      21  0.0% 01-Feb-91 13:02:28 +patchlevel.h
  122.     5829    1944 66.6% 08-Jul-95 21:40:36 +paths.c
  123.      225     138 38.6% 01-Feb-91 13:03:46 +radix.h
  124.     1532     853 44.3% 17-Sep-95 14:39:16 +raw.c
  125.     6387    2075 67.5% 08-Jul-95 20:40:30 +scan-asm.c
  126.     6845    2215 67.6% 17-Sep-95 14:47:20 +scan-c.c
  127.     1170     537 54.1% 17-Sep-95 14:48:58 +SMakefile
  128.     1883     682 63.7% 01-Feb-91 13:04:30 +stoi.c
  129.      735     348 52.6% 08-Jul-95 21:40:52 +string.h
  130.      648     353 45.5% 01-Feb-91 13:04:08 +test.c
  131.     1874     644 65.6% 17-Sep-95 14:31:58 +tty.c
  132.      630     358 43.1% 29-Jun-95 20:48:16 +uerror.c
  133.      830     479 42.2% 01-Feb-91 13:04:46 +wmatch.c
  134.      546     335 38.6% 01-Feb-91 13:02:08  todo
  135.    16037    6305 60.6% 01-Feb-91 13:01:14  TUTORIAL
  136. -------- ------- ----- --------- --------
  137.   302187  150447 50.2% 17-Sep-95 16:22:28   51 files
  138.